home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 12 / Mac Magazin and MacEasy Magazine CD - Issue 12.iso / Sharewarebibliothek / Utilities / TattleTech 2.20 / Program Files / TattleTech Master 2.20 / TattleTech Master 2.20.rsrc / TEXT_5561_T-Help App.txt < prev    next >
Text File  |  1995-07-15  |  16KB  |  145 lines

  1. What is TattleTech?
  2.     TattleTech¬Æ has its origins in the shareware program TattleTale‚Ñ¢.  TattleTech provides very complete information about your computer, peripherals, and system software.  The information can be viewed on screen by category, printed, written to a standard text file in standard or a special Bug Report format, or output in database readable format.  As such, it also provides a record of your system configuration that can be used for reporting problems to software and hardware manufacturers, to compare configurations across multiple computers, or to simply learn about your machine.  Information categories covered are:  General Hardware, Volumes + Drives, Monitors, Nubus Devices, SCSI Devices, ADB Devices, Serial Ports,Startup Environment (Boot Blocks, INITs Files, Other System Files (System, Finder, cdevs, etc.)), General System software, Processes, DAs, Fonts, Drivers, Open Files, Traps and their Patches, Applications, Special Resources, Special Files, and specific File/Folder information.  In addition, it enables you to Mount Volumes, Close Files that were left open, and examine and set File and Folder Attributes.  The information provided varies greatly among these categories and is best understood simply by going to the dialog window and browsing through the above categories.
  3.     NOTES:  If you received this copy of TattleTech as part of another product, some of the features mention above may not be available.  Methods for contacting Decision Maker‚Äôs Software may be found at the end of this document.  
  4.  
  5. System Requirements
  6.     TattleTech is compatible with the Mac+ and newer machines running System 6.04 or higher. 
  7.  
  8. Installing TattleTech
  9.     TattleTech consists of up to three files for operation:
  10.  
  11. ‚Ä¢    TattleTech
  12. ‚Ä¢    TattleINIT
  13. ‚Ä¢    Tattle.Traps
  14.  
  15.     TattleINIT is not required for normal operation of TattleTech.   TattleTech defaults to using internal INIT information generating routines if the generated files are not found.  TattleINIT, if used, must be in the System Folder on 6.X systems and in the Extensions folder on 7.X systems. TattleINIT should be placed alphabetically at the beginning of the folder so the program can gather information on all subsequently loaded INITs. Its name is preceded by two non-printing characters to facilitate this.  These two non-printing characters may be changed to other non-printing characters to accommodate INIT ordering requirements. (see Conflicts and Limitations below)
  16.     When TattleINIT runs at startup, it creates two files in the System Folder: TTINIT.TRecs and TTINIT.FRecs. These files contain information about the INITs that run after TattleINIT,  and are used by TattleTech in subsequent reports.  The first time TattleTech is run after start-up it converts these two files to TTINIT.TDB and TTINIT.FDB respectively.
  17.     Tattle.Traps, is required for all of the Trap-related reports except the Traps Patched by INITs report.  Tattle.Traps if used, must be located in the System Folder.
  18.     In addition to the files listed, there are a number of files that provide for Registration and other support for TattleTech.  Please refer to the manual for more information.  
  19.  
  20. Conflicts and Limitations
  21.     This section describes conflicts with other software and system limitations that affect TattleTech.
  22.  
  23. Accelerator Cards
  24.     Two conditions involving accelerator cards affect TattleTech.  First, if your Macintosh has an accelerator card installed that copies ROM to RAM, you may need to disable this feature to run TattleTech. This problem occurs primarily on the Mac+/SE, but may occur with other configurations.
  25.     Second, if you have a Daystar Accelerator and:
  26. ‚Ä¢    PowerCentral v2.0 with Enhanced FP routines is enabled, and
  27. ‚Ä¢    QuickTime or Apple Photo Access is installed,
  28.     then you must disable Daystar Enhanced FP routines in the control panel.
  29.  
  30. Extension Manager
  31.     If you are running Extension Manager, EM Extension must be placed before TattleINIT in the Extensions folder.
  32.  
  33. List Manager
  34.     To conserve space, TattleTech uses the standard List Manager for both "Screen Reports" or "Printed Reports" and is therefore limited to 32K characters. Normally this is sufficient to handle the various lists within each Category. If a list runs out of space, however, a message is posted at the bottom of the list window. In this case, a full listing of the Category can be obtained by writing the Category report to the various forms of text files as described in Writing Reports to a Text File.
  35.  
  36. Using TattleTech
  37.  
  38. Selecting Categories From the Main Dialog Window
  39.     TattleTech consists primarily of the TattleTech dialog window and the TattleTech menu. Upon launch, the Main dialog window is visible and the first Category of information, General Hardware, is displayed in a scrolling "Screen Report" in the window.  You can select other Categories from the pop-up menu above the list.  Categories that are not available for a given computer and system software combination (for example, Nubus on a Mac+ or Processes under Uni-Finder in System 6.X) are disabled and cannot be selected. 
  40.  
  41. Definitions
  42.     The Definitions button at the bottom of the dialog displays definitions for the fields contained in the displayed Category.
  43.  
  44. Other Buttons/Functionality
  45.     When Volumes/Drives is displayed, the Mount button appears.  This button attempts to mount any unmounted volumes.  
  46.     In the case of the Open Files Category, the Close‚Ķ button appears.  This button invokes another dialog which allows you to close any open file in the list.  This Category also has a special listing feature.  If you hold down the <option> key before selecting this menu item, any open Font files will not be listed.
  47.     When File/Folder Info‚Ķ is displayed, the Set‚Ķ button appears.  This button invokes a dialog which allows you to set various attributes related to the file or folder currently displayed. 
  48.     When Nubus/PDS Slots is displayed, the All Slots checkbox appears which forces the list to include slots with assigned functionality but no physical slot card.  This is also true if the <cmd> key is held down while choosing Reports... from the TattleTech pull down menu. 
  49.     The Other System Files Category has two special listing features.  If you hold down the <option> key before selecting this menu item, only Special Files in the System Folder specified with  Configure TattleTech will be listed.  If you hold down the <shift> key before selecting this menu item, all other system files will be listed. 
  50.     The Applications and DAs reports have a special feature under System 7.X.  If you hold down the <option> key before selecting these menu items, the listing will be alphabetically sorted across volumes.   This is also true if the <option> key is held down while choosing Reports... from the TattleTech pull down menu.
  51.     
  52. Copying Data Fields to Other Applications
  53.     Data Field lines in the "Screen Report" can be selected and copied to other documents.
  54.  
  55. Closing and Quitting
  56.     Click the Close button or the Close box to close the window but leave TattleTech active.  Get System Info in the TattleTech menu reopens the window.  Select Quit from the File menu to quit completely.
  57.  
  58. Getting Help
  59.     Selecting General Help... from the TattleTech menu activates an abbreviated on-line version of the TattleTech manual.
  60.  
  61. Printing the Current Category
  62.     Select Print Current...  from the TattleTech menu to print the Category that is currently displayed in the dialog.
  63.  
  64. Page Setup
  65.     Select Page Setup‚Ķ to set parameters for printing report pages.
  66.  
  67. Specifying Volumes
  68.     Specify Volume allows you to restrict the volumes for which files are reported.  The Specify Volume menu item applies only to the Special Files, Applications, and DAs (System 7) reports available in the pop-up menu.
  69.  
  70. Generating Reports
  71.     Select Reports... from the TattleTech pull down menu.  Select the Categories you want to report by selecting their checkboxes. Click the All button to select all Categories. Click the None button to de-select the Categories.  Select Default Reports to choose the standard preset Categories. 
  72.  
  73. TattleTech Reports
  74.     TattleTech provides several options for reporting the different Categories of information.  The following is a list of available reports:
  75.  
  76. ‚Ä¢    "Screen Report" (See Selecting Categories From the Main Dialog Window above.)
  77. ‚Ä¢    "Printed Report"
  78. ‚Ä¢    "Standard Text File Report"
  79. ‚Ä¢    "Bug Report"
  80. ‚Ä¢    "Tab-Delimited Text File Report"
  81.  
  82. "Printed Report"
  83.     To print the selected Categories to a printer, select the Categories that you want to print, click the Print Std Reports button, and then click OK.
  84.  
  85. Writing Reports to a Text File
  86.     Writing reports to text files offers flexibility in communicating and using the information that TattleTech provides.   In addition, TattleTech uses the standard List Manager for both "Screen Reports" or "Printed Reports" and is therefore limited to 32K characters. Normally this is sufficient to handle the various lists within each Category.  If a list runs out of space, however, a message is posted at the bottom of the list window. In this case, a full listing of the Category can be obtained by writing the Category report to the various forms of text files as described below.
  87.  
  88. Writing a "Standard Text File Report" 
  89.     To write the selected Categories to the "Standard Text File Report", click the Write Std Reports to Text File radio button.
  90.  
  91. Writing a "Bug Report" to a Text File
  92.     Click the Write Bug Report to Text File radio button to add "bug report" information to the "Standard Text File Report".
  93.     Clicking the Bug Explanation... button accesses a dialog that allows you to describe the problem and to Save and Load the text that you have created for future reference. 
  94.     The User Info... button allows you to input standard information including who you are and how you can be contacted.  This information is read at program startup and is retained until changed by you.  
  95.  
  96. Note:    
  97.     Generally, in cases where a particular Data Field is not an appropriate or possible attribute of a particular machine configuration, that attribute is not included in any report other than the "Tab-Delimited Text File Report". (Please refer to Writing the "Tab-Delimited Text File Report".)  An example of this would be the reporting of DuoDock attributes for a Quadra, which cannot possibly have a DuoDock.  
  98.  
  99. Writing the "Tab-Delimited Text File Report"
  100.     To write the selected Categories to the "Tab-Delimited Text File Report" and thereby create a database-readable file, click the Write to Tab-Delimited Text File radio button. 
  101.  
  102. Set Unit Info
  103.     Click the Set Unit Info... button in the same dialog to enter information related to the owner of the system. Click the Unit Info checkbox to place this information at the beginning of the three text file reports ("Standard Text File Report", "Bug Report", and "Tab-Delimited Text File Report").  The information is preserved the next time TattleTech is launched.
  104.  
  105. ‚Ä¢ Miscellaneous Issues:
  106.     If you are running System 7 and the finder does not automatically update the icons for you, TattleTech can do it for you.  As you start up TattleTech, simply hold down the ‚Äú<option> d‚Äù key combination until a dialog comes up which asks if you wish update the desktop database.  If you hear a ‚Äúbeep‚Äù during updating, the updating was not performed for various possible reasons.  In this event, your desktop database will be left in its original state and the program will continue.  If updated, the new icons will appear after a subsequent machine restart.  This method avoids having to rebuild your desktop (which is very time consuming on a large disk) just to update icons.
  107.  
  108. ‚Ä¢ BUG¬†REPORTS:
  109.     Bug Reports, comments, suggestions, etc. are welcome and encouraged regarding any matter whatsoever.  Given the nature of TattleTech, however, please follow these guidelines in submitting a bug report:  use the ‚ÄúWrite Bug Reports to Text File‚Äù option explained below, include ONLY the General Hardware and General Software reports with your first message, compress the file, and then email it to one of the addresses below.  Alternatively, if you want to include these two reports in the text of a regular message (by selecting, copying, and pasting), please make sure that you also include an adequate description of your problem and the actions that lead to it.  After reviewing your report, I will get back to you for any additional information required.  I am making this request due to the number of ‚Äúvery complete‚Äù reports which I have received.  Given the total amount of information that TattleTech can generate, this can amount to considerable cost in time and money both for uploading and downloading.
  110.  
  111. ‚Ä¢ REGISTRATION:  This product is not free.  Please refer to the accompanying Registration/Pricing document for details on how to Register using Configure TattleTech.
  112.  
  113. ‚Ä¢ LICENSE AGREEMENT: 
  114.     Any entity who distributes and/or uses TattleTech¬Æ and any other accompanying software and documentation (‚ÄúLicensee‚Äù) agrees to be bound by this License Agreement.  
  115.     The TattleTech program is copyrighted and the TattleTech¬Æ name is a registered trademark.  TattleTech, its documentation, and any accompanying software represent proprietary program products and information of Decision Makers Software, Inc. (‚ÄúLicensor‚Äù).  Licensee agrees not to reverse engineer, disassemble or decompile the licensed software in whole or part. Licensee may modify the licensed software only in the manner provided for either by the software itself or through ancillary programs provided by the Licensor expressly for modification or customization purposes.  
  116.     All rights under the copyright laws are reserved.
  117.  
  118. Warranty:  (Applies Only to Registered Users)
  119.     Licensee acknowledges that all licensed software items are of such complexity that they may have inherent defects, and agrees that as Licensor's sole liability and as Licensee's sole remedy, Licensor will attempt to provide services to correct documented errors that Licensor's diagnosis indicates are caused by a defect in an unaltered version of the delivered licensed software. Licensor does not guarantee the results of any such services or represent or warrant that any or all errors will be corrected.  This warranty only applies to Licensees who have Registered with the Licensor.
  120.  
  121. Limitation of Liability: 
  122.     Except for the express warranty set forth above, Licensor grants no warranties, either express or implied, with regard to any licensed software including, but not limited to, merchantability and fitness for a particular purpose. The stated express warranty is in lieu of all liabilities or obligations of Licensor for damages arising out of or in connection with the delivery, use, or performance of licensed software. In no event shall Licensor be liable for incidental or consequential damages.  Licensee also agrees to indemnify Licensor for any and all claims made by any entities to whom they distribute TattleTech.
  123.     Any use not in conformance with this Software License Agreement is expressly prohibited.
  124.  
  125. ‚Ä¢ DISTRIBUTION 
  126.     TattleTech may be freely distributed in its Pre-Registered form at no charge except media costs or normal downloading charges provided that all documentation, auxiliary programs, registration and pricing information, and all other files in their original form accompany it.  Any inclusion on media greater in capacity than 1.4 MB must be approved in advance.  In addition, it may not be used, sold, included with other software sold commercially, or utilized in any commercial venture not already delineated without either payment of the appropriate Registration Fee or specific permission from Decision Maker‚Äôs Software, Inc.  If you are in doubt, please contact us.
  127.  
  128. TattleTech ¬©1991-1993, Decision Maker‚Äôs Software, Inc., All Rights Reserved
  129.  
  130. ‚Ä¢  A special thanks to Dick Hodges for his help in the original beta testing.
  131. ‚Ä¢  A special thanks also to Onset Computer Corporation which has granted permission for the original use of their         ‚ÄúTattleTale‚Äù Trademark.
  132.  
  133. Issues regarding licensing, marketing, and general business issues should be sent to:
  134.  
  135. Tech Tools
  136. Decision Maker‚Äôs Software, Inc
  137. 1910 Joslyn Place 
  138. Boulder, CO  80304
  139. Fax 303/449-6207
  140.  
  141. Internet: mancino@decismkr.com
  142. AppleLink: D0391    
  143. America Online: JGCMan
  144. Compuserve: 70337,2143
  145. eWorld: JMancino